Inside Macintosh: Telephony /

Chapter 4 - Call Appearances / Call Appearance Reference

Call Appearance Functions / Dropping a Call

TELDrop

Drops a call.

pascal TELErr TELDrop (
                     TELCAHandle hTELCA, 
                     ConstStr255Param userUserInfo);

hTELCA

A handle to a call appearance structure for the call to be dropped.

userUserInfo

A pointer to a Pascal-style string containing user-to-user information, as defined by some telephone networks. You should set this parameter if the network supports user-to-user information. To find out, call the function TELGetInfo and check the bit hasUserUserInfo in the telephone structure.

function result

A result code.

DESCRIPTION

You can drop any call at any time, regardless of the state of the call. When TELDrop returns noErr, the call state reverts to telCAIdleState and your call appearance message handler gets the telCAIdleMsg message.

Do not reuse a call appearance structure. After dropping a call and getting the telCAIdleMsg message, call TELCADispose (page 4-52) to dispose of the call appearance structure.

Note

Functions that can dispose of a handle to a call appearance structure (TELCADispose, TELDNDispose, and TELDispose) do not drop the associated telephone call. For example, if you call TELCADispose for an active call, the parties can continue to talk until one or the other hangs up. However, your application can no longer monitor or control the call.

SEE ALSO

The function TELDNSelect (page 3-19) can cause all calls on a given directory number to be dropped.